..
  This file was automatically converted from MediaWiki syntax.
  If some markup is wrong, looks weird or doesn't make sense, feel free
  to fix it.

  Please remove this comment once this file was manually checked
  and no "strange ReST" artifacts remain.

.. _configuring-panda3d:

Configuring Panda3D
===================

In the etc subdirectory, you will find a configuration file Config.prc. This
controls several of Panda's configuration options - does it use OpenGL or
DirectX, how much debugging output does it print, and so forth. The following
table lists several of the most commonly-used variables.

For a full documentation about Panda3D's configuration system, click
`here <http://panda3d.cvs.sourceforge.net/*checkout*/panda3d/panda/src/doc/howto.use_config.txt>`__
to view the original documentation file.

To know about accessing config variables from within your code, please see
:ref:`accessing-config-vars-in-a-program`.

To get a more complete list of variables, see the
:ref:`list-of-all-config-variables`.

+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Variable                 | Values             | Default              | Details                                                                                                                                                    |
+==========================+====================+======================+============================================================================================================================================================+
| load-display             | pandagl            | pandagl              | Specifies which graphics GSG to use for rendering (OpenGL, Direct3D 8/9 or TinyPanda software rendering)                                                   |
|                          |                    |                      |                                                                                                                                                            |
|                          | pandadx9           |                      |                                                                                                                                                            |
|                          |                    |                      |                                                                                                                                                            |
|                          | pandadx8           |                      |                                                                                                                                                            |
|                          |                    |                      |                                                                                                                                                            |
|                          | tinydisplay        |                      |                                                                                                                                                            |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| aux-display              | pandagl            | pandagl              | Specifies which graphics GSG to use if the GSG specified in load-display fails; May be specified multiple times to create multiple fallbacks.              |
|                          |                    |                      |                                                                                                                                                            |
|                          | pandadx9           |                      |                                                                                                                                                            |
|                          |                    |                      |                                                                                                                                                            |
|                          | pandadx8           |                      |                                                                                                                                                            |
|                          |                    |                      |                                                                                                                                                            |
|                          | tinydisplay        |                      |                                                                                                                                                            |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| win-size                 | Number of pixels   | 640 480              | Specifies the size of the Panda3D window                                                                                                                   |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| win-origin               | Pixel offsets      | 50 50                | Specifies the offset of the Panda3D window                                                                                                                 |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| window-title             | Window title       | Panda                | Specifies the title of the Panda3D window                                                                                                                  |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| fullscreen               | #. t               | #. f                 | Enables full-screen mode (true or false)                                                                                                                   |
|                          |                    |                      |                                                                                                                                                            |
|                          | #. f               |                      |                                                                                                                                                            |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| undecorated              | #. t               | #. f                 | Removes border from window (true or false)                                                                                                                 |
|                          |                    |                      |                                                                                                                                                            |
|                          | #. f               |                      |                                                                                                                                                            |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| cursor-hidden            | #. t               | #. f                 | Hides mouse cursor (true or false)                                                                                                                         |
|                          |                    |                      |                                                                                                                                                            |
|                          | #. f               |                      |                                                                                                                                                            |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| sync-video               | #. t               | #. t                 | Limits the frame rate to monitor's capabilities                                                                                                            |
|                          |                    |                      |                                                                                                                                                            |
|                          | #. f               |                      |                                                                                                                                                            |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| show-frame-rate-meter    | #. t               | #. f                 | Shows the frame rate (in frames per second) at the upper right corner of the screen (true or false)                                                        |
|                          |                    |                      |                                                                                                                                                            |
|                          | #. f               |                      |                                                                                                                                                            |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| notify-level-[package]   | fatal              | info                 | Sets notification levels for various Panda3D packages to control the amount of information printed during execution (fatal being least, spam being most)   |
|                          |                    |                      |                                                                                                                                                            |
|                          | error              |                      |                                                                                                                                                            |
|                          |                    |                      |                                                                                                                                                            |
|                          | warning            |                      |                                                                                                                                                            |
|                          |                    |                      |                                                                                                                                                            |
|                          | info               |                      |                                                                                                                                                            |
|                          |                    |                      |                                                                                                                                                            |
|                          | debug              |                      |                                                                                                                                                            |
|                          |                    |                      |                                                                                                                                                            |
|                          | spam               |                      |                                                                                                                                                            |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| model-path               | Path string        | see config file      | Adds specified path to the list of paths searched when loading a model                                                                                     |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| audio-library-name       | p3openal\_audio    | p3openal\_audio      | Loads the appropriate audio library                                                                                                                        |
|                          |                    |                      |                                                                                                                                                            |
|                          | p3fmod\_audio      |                      |                                                                                                                                                            |
|                          |                    |                      |                                                                                                                                                            |
|                          | p3miles\_audio     |                      |                                                                                                                                                            |
|                          |                    |                      |                                                                                                                                                            |
|                          | null               |                      |                                                                                                                                                            |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| want-directtools         | #. t               | #. t                 | Enables directtools, a suite of interactive object/camera manipulation tools                                                                               |
|                          |                    |                      |                                                                                                                                                            |
|                          | #. f               | line commented out   |                                                                                                                                                            |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| want-tk                  | #. t               | #. t                 | Enables support for using Tkinter/PMW (Python’s wrappers around Tk)                                                                                        |
|                          |                    |                      |                                                                                                                                                            |
|                          | #. f               | line commented out   |                                                                                                                                                            |
+--------------------------+--------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+